home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / ASTRONOM / 1479.ZIP / CLUSTER.ARC / CLUSTER.DOC < prev    next >
Text File  |  1988-06-30  |  4KB  |  120 lines

  1. +--------------------------------------------------------------------+
  2. |                    STAR CLUSTER SIMULATOR                          |
  3. +--------------------------------------------------------------------+
  4.  
  5. Introduction
  6. ------------
  7.  
  8. This program graphically simulates the motion of objects in space 
  9. (stars, planets, spacecraft, etc.).  
  10. To run the program, perform the following steps: 
  11.  
  12. 1) type  "cluster" 
  13. 2) read a data file ('R' option).
  14. 3) execute simulation ('X' option).
  15.  
  16.  
  17. Explanation 
  18. -----------
  19.  
  20.      Cluster is a program that simulates stellar mechanics, i.e. the 
  21. effect of gravity on the motion of objects in space.  It can be used 
  22. to model the motion of stars in a cluster, or of planets around a sun.  
  23.  
  24.      To set up a simulation, you need to specify the location, velocity 
  25. and mass of the bodies.  This is done by creating a data file which 
  26. lists this data for each object.  (Note:  The data files for cluster 
  27. use the extension ".cdt".) 
  28.  
  29.      The format of this data file starts with one comment line 
  30. describing the simulation, followed by a data line for each object.  
  31. Rectangular co-ordinates are used for the position and velocity.  Each 
  32. line contains in sequence the x-position, y-position, z-position, 
  33. x-velocity, y-velocity, z-velocity and mass.  
  34.  
  35.      The position and velocity are represented in Astronomical Units 
  36. (AU).  An AU is the average distance of the earth from the sun.  The 
  37. basic time unit is one earth year.  The masses are measured in solar 
  38. units where the mass of our sun is 1.  In selecting the coordinates, 
  39. remember that the display will always be centered around the point 
  40. (0,0,0).  The actual scale is determined automatically based on the 
  41. values chosen for the coordinates.  For star travellers, one light 
  42. year is approximately 63.4 AU.  (Hint:  It's very easy to use a
  43. spreadsheet to create these data files.)
  44.  
  45.      The simulation can be run at a number of speeds for greater or
  46. lesser accuracy.  The program also automatically reduces the selected
  47. time increment when the objects get very close to maintain a reason-
  48. able overall accuracy.
  49.  
  50.      Several sample data sets are included with the distribution 
  51. package.  
  52.  
  53.  
  54. References
  55. ----------
  56.  
  57.      This program was inspired by the article "A Cosmic Display" by
  58. A.K. Dewdney which first appeared in Scientific American and was later
  59. republished in the book "The Armchair Universe" (which I highly 
  60. recommend).  
  61. 
  62. Technical Information
  63. ---------------------
  64.  
  65.     Cluster is written in Turbo C, Version 1.5, using the Borland 
  66. Graphics Interface (BGI) library.  The program includes graphic 
  67. drivers for the following display devices:  CGA, EGA, VGA and Hercules 
  68. monochrome.  For calculations, it uses the math emulation library and 
  69. will run on machines with or without a math coprocessor.  The actual 
  70. source code is approximately 16K in size and is available to 
  71. registered users.  
  72.  
  73.  
  74. Registration
  75. ------------
  76.  
  77.     Your financial support will encourage the programmer and entitle 
  78. you to a future version of this program.
  79.  
  80.   [1] For $10 you become a registered user which entitles you to a free 
  81. upgrade to the next version, and notification of subsquent revisions.
  82.  
  83.   [2] For $20 you become a registered hacker and will be sent the source 
  84. code of the current version, and notifications of future revisions.
  85.  
  86.  
  87. Yes, I wish to be a real celestial mechanic:
  88.  
  89.  
  90.    Name: __________________________________________________________
  91.  
  92. Address: __________________________________________________________
  93.  
  94.          __________________________________________________________
  95.  
  96.    City: _______________________________  State: ____  ZIP: _______
  97.  
  98.  
  99.  
  100.  User ($10)  ___    Hacker  ($20) ____    Total Enclosed    _______
  101.  
  102.  
  103. What version of the program do you have ?  ________________________
  104.  
  105. Where did you get a copy of this program ?  _______________________
  106.  
  107. Do you have any suggestions for additions to the next version ?
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Make checks payable to:  David E. White 
  115.  
  116. Mail to:   David E. White
  117.            55 Bow Street
  118.            Arlington, MA  02174
  119.  
  120.